deutsch

STIMP_geom: MANUAL




PURPOSE


The archive contains several programs for geometrical and logical operations.


ARCHIVE CONTENTS


The archive should enclose the following files:

main directory

directory bin/

directory doc/

directory doc/gfx/

directory help/

directory Ultraconv/

directory Ultraconv/Catalogs/

directory Ultraconv/Catalogs/Deutsch/

directory Ultraconv/ReqDesc/

If one of this files is missing, it would be better to get a full version of the archive, best you get it directly from my homepage.


SHAREWARE VERSION


This package is SHAREWARE. All files in this archive are copyrighted, that means (c) Stefan Diener. You may freely redistibute this archive, but it is not allowed to modify the archive and to distibute the modified form. (It´s especially not allowed to remove this notice !)

Any exception requires my personal agreement.

This package contains:

REGISTERED VERSION


If you are using parts of this software regulary, it is your duty to register for this package. Your advantages:
Think about it and you will see, it is worth registering.

Prices:
First STIMP package - Germany
cash OR euro-chequeC.O.D.direct transfer to my account
via email10 DM-10 DM
by post15 DM23 DM15 DM


Second++ STIMP package - Germany
cash OR euro-chequeC.O.D.direct transfer to my account
via email6 DM-6 DM
by post11 DM19 DM11 DM


Germany only: If you want to transfer the money directly to my account, please use the following data. Please send me an email or a letter with your desire and your detailed adress too.

number of account: 100 711 53 04
name of bank: Advance Bank, Munich
BLZ: 702 300 00
purpose: "your name"

My address: Stefan Diener, Wilhelmstr. 7, D-73433 Aalen, Germany.


First STIMP package - Europe, World
cash OR euro-cheque
via email10 DM/6 US$
by post15 DM/9 US$
by air mail17 DM/11 US$


Second++ STIMP package - Europe, World
cash OR euro-cheque
via email6 DM/4 US$
by post11 DM/7 US$
by air mail13 DM/8 US$


My address: Stefan Diener, Wilhelmstr. 7, D-73433 Aalen, Germany.

If you are a registered user you have to take a look at the different copyright definitions:

Any exception requires my personal agreement.


VERSION


This guide was made for the release 1.01 of this package. If you have a newer version of the whole archive just forget this file.


GUARANTEE


Sorry, but there is no guarantee given. There´s no guarantee whether the program runs on your computer or that it will do the job you thought it should. Nobody gives any liability for damages caused by proper or inproper use of the program. There´s no guarantee that the program´s output will be correct. No liability too. You are using the program at your own risk.

BUT: I was heavily working to debug the program and I spent a lot of time for testing it. The chance of undiscovered bugs is still greater than zero.


REQUIREMENTS


STIMP_geom requires the following things:

INSTALLATION


  1. Use the Installer-script "Install" !

  2. You may install the package by hand too, but on your own risk !
    I'm sorry, but I cannot give detailed instructions anymore.


USAGE OF THE PROGRAM


You can get the usage of one of the programs by starting it without any options: for instance "pgmmedian". If no usage appers, it is possible that the installation was not succesfull or any other error appeared ... (Maybe you forgot the reset ?)

Note: The option "-?" is no longer available.

I think that the programs help texts should be enough for a short explanation of all options. If you need more information you have to take a look at the programs documentation (not included in the SHAREWARE version).

Some hints for the "Syntax" line:


REDIRECTIONS


A new feature is the possibility to use input- and output-redirection. The only thing you have to do is replacing the (now useless) file name by a "-". Some examples:
  1. normal form:
    "pgmmedian lena.pgm result.pgm"
    (where lena.pgm is the input file and result.pgm the output file)
  2. output-redirection:
    "pgmmedian lena.pgm - >result.pgm"
  3. input-redirection:
    "pgmmedian - result.pgm <lena.pgm"
  4. input- and output-redirection:
    "pgmmedian - - <lena.pgm >result.pgm"
  5. using pipes (greets from UNIX):
    "pgmmedian lena.pgm - | pnmmargin -a0 -m5 - result.pgm"
  6. or more complicated with 2 pipes:
    "pnmaddnoise -w0.8 -p20.0 lena.pgm - | pgmmedian - - | pnmview -"
    (Note: You need a newer version than 0.01ß of the program pnmview to use the input-redirection ...)

I added this feature mainly for use with Ultraconv, but it is useful for running the programs on UNIX too.

Note: You need additional software to use pipes on AmigaOS.

ULTRACONV 3


Three programs of STIMP_geom are integrated into Ultraconv3: pnmfit, pnmcarith, pnmclogic. More programs (pnmarith, pnmlogic, pnmdoublepack) will follow soon -> registered users will get these support !


RESTRICTIONS


Only the binary versions of PBM/PGM/PPM-files are supported. That means that you can not use file with the markers P1, P2 and P3 (text versions). I decided to do so because all programs of the NetPBM package write binary files and the text versions have the big fault to produce unneccessary big files. In practice this is no real restriction.

SOURCE CODE


The source code for this package is not available at the moment. Registered users will get (parts of) the source code with the registered version.


WHAT MEANS STIMP ?


If you read the "Registered version" paragraph, you might be wondered by "STIMP". It´s quite simple: "STefan´s IMage Processing". Not surprising, isn´t it ?


ENVIRONMENT


Compiler:

Computer:

AUTHOR


name : Stefan Diener
e-mail : stefan.diener@freepage.de
WWW : http://private.freepage.de/stefan.diener/index.html
address : Bornrasen 12, D-99762 Osterode, Germany